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Core Object Model for Network Management Configuration Applications in 

Telecommunication Systems 

CROSS REFEENCE TO RELATED APPLICATION 

5 This application claims priority of Provisional Application Serial No. 60/264934 

which was filed January 3 0, 200 1 . 

FIELD OF THE INVENTION 

The present invention relates generally to the field of Network Management in 
10 Telecommunication Systems, and more specifically to an object model for such a 
Network Management system. 

BACKGROUND OF THE INVENTION 

The Network Management Configuration Domain for Telecommunication 
15 Systems suffers from not having a generic object model that addresses the issues of 
modeling telecommunications physical and logical components and devices. Different 
Network Management vendors have proprietary modeling schemas that reflect object 
models that are similar to their device structure. These proprietary models, however, are 
difficult to re-use and extend to build a generic Network Management Configuration 
20 object model. The problem of not having a Core Network Management object model that 
is generic and re-usable translates into having to re-architect the object model multiple 
times which consumes valuable design and implementation time, energy and cost. 

Existing Network Management System (NMS) configuration object models have 
various shortcomings including not having isolation of business logic in just the specific 
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leaf objects, but rather being proliferated throughout the object model; not 
distinguishing properly between Network Management Action objects that are required to 
manipulate specific core objects; and lacking an interaction mechanism to make the 
objects completely unaware of session and event information. In addition, prior art NMS 
configuration object models lack abstraction so as to be generically applicable to any 
network management object model and are not easily re-usable. 

Accordingly, a need exists for a generic and re-usable core network management 
object and action model will solve the above problems. 

SUMMARY OF THE INVENTION: 

The Core Network Management Object Model of the present invention 
generically models the physical and logical objects in a configuration management 
system. The present invention also models the generic action objects required to 
manipulate the network objects. Unique object level information is isolated at the leaf 
level of the object model and is not proliferated to other generic parts of the model. The 
action objects all model different actions that need to be performed in a configuration 
application architecture and insulates the network objects from having any knowledge of 
session and event information. Leaf objects and actions are specialized to perform any 
configuration related actions. In the Core Network Management Object Model an Object 
Factory creates the unique object and an Action Factory creates the unique action. The 
action shall then be performed on the unique object to get, set and modify device 
information through SNMP and also to store the information in the database. This makes 
the object model for both the network objects and actions re-usable, scalable, and 
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extendable. Use of the present invention drastically reduces development time and effort 
so that the same objects can be re-used in different applications and solutions. 

BRIEF DESCRIPTION OF THE DRAWINGS 

A more complete understanding of the present invention may be obtained from 
consideration of the following detailed description of the invention in conjunction with 
the drawing, with like elements referenced with like references, in which: 

FIG. 1 is an exemplary embodiment of a core network management object model 
with circuit objects as leaf entities; 

FIG. 2 is an exemplary embodiment of a core network management object model 
with logical ports as leaf entities; 

FIG. 3 is an exemplary data flow diagram for a specific request in the object 

model 

DETAILED DESCRIPTION OF THE INVENTION: 

The present invention is a Core Network Management Object Model that 
generically models the physical and logical objects of a configuration management 
system. The invention also models generic action objects required to manipulate the 
network objects. Unique object level information is isolated at the leaf level of the object 
model and is not proliferated to other generic parts of the model Action objects model 
different actions that need to be performed in a configuration application architecture and 
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insulate the network objects from having any knowledge of session and event 
information. Leaf objects and actions are specialized to perform any configuration related 
actions. 

In the Core Network Management Object Model of the present invention, an 
Object Factory creates the unique object and the Action Factory creates the unique action. 
The action shall then be performed on the unique object to get, set and modify device 
information through SNMP and also to store the information in the database. This makes 
the object model for both the network objects and actions re-usable, scalable, and 
extendable. This drastically reduces development time and effort so that the same objects 
can be re-used in different applications and solutions. 

The Core Network Management Object Model of the present invention can be 
directly used in implementing most any Network Management application so that the 
usage of the model is immediate. The reusability feature of the model greatly enhances 
the cost savings in implementing this object structure. The core object model can 
translate into significant savings by providing a software object model that simplifies 
architecture, design and development of any NMS application. 

Referring generally to Fig. 1, the Core Network Management Object Model 
architecture of the present invention includes a series of fundamental objects that 
represent the root of an inheritance tree for Network Management Configuration 
Applications. The object model can be extended to build a network management 
configuration object hierarchy. This helps specific developers to build applications by 
using base classes and interfaces provided in the model instead of defining their own 
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object architecture. The "BFW" pre-fix is used in the object model to denote Base 
Framework objects. The "Ifc" post-fix is used to denote interface objects. The "Impl" 
post-fix is used to denote implementation objects. 

The object models 100, 200 of Figs. 1 and 2 are represented and described using 
nomenclature of the Java programming language. As would be understood by those 
skilled in the art of computer programming, the object models of the present invention are 
equally applicable to other similar programming languages. As shown, the object models 
of the present invention include abstract classes, standard classes and interface objects. 
As would also be understood, a Class is a way to group data and methods together into 
one coherent package and an Object is a unique instance of a class. Relations and 
inheritances (the idea of using one class to create another) between classes and objects are 
illustrated with unbroken lines and arrows, respectively. Implementations between 
classes and interface objects, where an interface defines methods that a class implements, 
are illustrated using broken arrows. 

Referring to Fig. 1, a description of the main interfaces and objects in the Core 
Network Management Object Model 100 follows. Beginning at the top section of the 
model 100 in the core classes box 102, a BFWBaselfc interface 104 provides capabilities 
needed by Core Network Management Objects. These capabilities allow an object to be 
initialized, uninitialized etc. The BFWBaselmplAbs abstract object 106 implements the 
BFWBaselfc interface 104. A BFWContainerlfc interface 108 is inherited from the 
BFWBaselfc interface 104. The BFWContainerlfc interface 108 is used in manipulation 
of contained objects. A BFWContainerlmplAbs abstract object 110 shall implement the 
BFWContainerlfc interface 108. 
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Proceeding generally downward in the model, a BFWObjectContainerlfc interface 
1 12 defines generic object container methods that are utilized by a BFWNetworkEntitylfc 
interface 1 14. The BFWObjectContainerlfc interface 112 supports creation, deletion, 
access, and naming of entities. The BFWObjectContainerlmplAbs object 116 implements 
5 the BFWObjectContainerlfc interface 1 12. The BFWNetworkEntitylfc interface 1 14 
allows dynamic extensions by implementing the BFWAttributeContainerlfc interface 118 
and the BFWObjectContainerlfc interface 1 12. A BFWNetworkEntitylmpl object 120 
implements the BFWNetworkEntitylfc interface 1 14. The BFWAttributeContainerlfc 
interface 118 defines generic attribute container methods that are utilized by the 
1 0 BFWNetworkEntitylfc interface 114. 

A BFWActionContainerlfc interface 122 is the base interface for all action objects 
that are transient in nature and operate on the network objects to perform the task. A 
BFWActionContainerlmplAbs object 124 implements the BFWActionContainerlfc 
interface 122. Below the BFWActionContainerlfc 122, the BFWActionlfc interface 
15 object 126 defines all actions required for network objects in the object model. The 
BF WActionlmplAbs object 1 28 implements the BFWActionlfc interface 1 26. 

As can be seen, the present invention model also includes a sample grouping of 
action classes 130. A BFWGetOperationallnfoActionlfc interface object 132 is 
responsible for getting operational information on network objects. The 
20 BFWGetOperationallnfoActionlmpl object 1 34 shall implement the get operational 
information interface. A BFWGetPeriodicStatisticsActionlfc interface object 136 is 
responsible for getting periodic statistics information on network objects. The 

BFWGetPeriodicStatisticsActionlmpl object 138 implements the get periodic statistics 
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information interface. A BFWGetStatisticsActionlfc interface object 140 performs single 
get operations on network objects. The BFWGetStatisticsActionlmpl object 142 
implements the get statistics information interface. 

A BFWStopStatisticsActionlfc interface object 144 performs stop operations on a 
network object. The BFWStopStatisticsActionlmpl object 146 implements the stop 
statistics interface. A BFWAddActionlfc interface object 148 performs the add action on 
a network object. The BFWAddActionlmpl object 150 implements the add action 
interface. A BFWDeleteActionlfc interface object 152 performs a delete action on a 
network object. The BFWDeleteActionlmpl object 154 implements the delete action 
interface. A BFWGetActionlfc interface object 156 performs the get operation on non- 
statistics attributes on a network object. The BFWGetActionlmpl object 158 implements 
the non-statistics get action interface. A BFWListObjectByParentActionlfc interface 160 
object performs the list by parent action on a network object. The 

BFWListObjectByParentlmpl object 162 implements the list by parent action interface. A 
BFWListObjectByTypeActionlfc interface object 164 performs list by object type action 
on a network object. The BFWListObjectByTypeActionlmpl object 166 implements the 
list by object action interface. 

As can be seen, the BFWActionlfc interface object 126 inherits each of the BFW 
"Action" interfaces below it. In a similar fashion, the BFWActionlmplAbs inherits all of 
the BFW "Action" implementation objects below. As shown, each of the BFW "Action" 
interface objects and each of the BFW "Action" implementation objects have a relation to 
all of the objects which fall underneath a respective object. 
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The Network Management Object Model of the present invention also includes a 
sample grouping of Circuit Classes 170. A GenericEntitylfc interface object 172 is the 
interface object for all generic network entities and is inherited by the 
BFWNetworkEntitylfc interface object 114. The GenericEntitylmplAbs object 174 
5 implements the GenericEntitylfc interface 172. As shown, the following interface 
objects: CircuitGenericEntitylfc 176, CircuitAxAtmlfc 178, CircuitAxCelfc 180, 
CircuitAxFramelfc 182, CircuitCoreAtmlfc 184, CircuitCoreCelfc 186, 
=f CircuitCoreFramelfc 1 88 shall represent all interface objects for different types of sample 

J Circuit objects. CircuitGenericEntitylmpl 190, CircuitAxAtmlmpl 192, CircuitAxCelmpl 

O 10 194, CircuitAxFramelmpl 195, CircuitCoreAtmlmpl 196, CircuitCoreCelmpl 197, 
y 3 CircuitCoreFramelmpl classes 1 98 shall represent implementations of the respective 

55 Circuit interface objects. The CircuitGenericEntitylfc interface object 176 inherits each 

yj of the "Circuit" interfaces below it. In a similar fashion, the 

H CircuitGenericEntitylmplAbs 190 inherits all of the "Circuit" implementation objects 

15 below. As shown, each of the Circuit interface objects and each of the Circuit 

implementation objects have a relation to all of the objects which fall underneath a 
respective object. 

Referring to Fig. 2, an exemplary embodiment of the core network management 

20 object model 200 of the present invention is shown with logical port (LPorts) connection 

classes 270 as leaf entities. As shown, the core classes and sample action classes are 

identical to the embodiment 100 of Fig. 1 (circuit objects). As with the circuit model, a 

GenericEntitylfc interface object 272 is the interface object for all generic network 
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entities and is inherited by the BFWNetworkEntitylfc interface object 214. The 
GenericEntitylmplAbs object 274 implements the generic network interface. The 
following interface objects: LportGenericEntitylfc 276, LportGenerallfc 278, 
LportEthernetlfc 280, LPortlLMIIfc 282, LportNodeToNodelfc 284, LPortPNNIIfc 286, 
LportTrunklfc 288, represent all interfaces objects for the different types of Logical Port 
objects. LportGenericEntitylmpl 290, LportGenerallmpl 292, LportEthernetlmpl 294, 
LPortlLMIImpl 295, LportNodeToNodelmpl 296, LPortPNNIImpl 297, LportTrunklmpl 
298 classes represent implementations of the respective Logical Port interface objects. 

Referring to Fig. 3, a Data Flow Diagram 300 of the Object Model of the present 
invention is shown. The overall interaction mechanism between the client 302 and the 
server 304 is that the client requests information from the server 304 and the server 
asynchronously creates unique objects and unique actions that will work on the object. 
The action object then manipulates the network object by getting information from the 
database and the device itself through SNMP, for example, to build the response for the 
client. After the construction of the response is complete and the information from the 
database and the device has been retrieved, the response is pushed back to the client. The 
exemplary data flow diagram depicts a client requesting get information on a specific 
object on the server. 

As a first step of Client and Server interaction for a get(. . .) request, a Client 
provides a request for configuration information in the form of a get request on a specific 
object by invoking a ConfigurationClientget(object, callback) request 306. At a next 
step, the request is serviced by the server 304 at the configuration request service which 
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generates a request createObject(. . .) 308 to the NetworkObjectFactory 3 1 0 to create the 
unique object e.g. configurationObject of type CircuitAxAtmlmpl. At step 3 12, this 
unique object called configurationObject is then returned to the Configuration Request 
Service 304. The Configuration Service 304 then creates a unique action at step 3 14 by 
calling the createAction static method on the ActionObjectFactory 3 16 to create a unique 
action getAction of type BFW GetActionlmpl. The unique action called getAction is 
then returned to the Configuration Request Service at step 318. The getDBInfo(. . .) 
method is then called to get Database information on the object at step 320. At step 322, 
the database information is returned to the service. The action object is then used to 
retrieve the SNMP information of the device by calling the SNMP API 324 at step 326. 
The SNMP API 324 then requests the get information on the specific object from the 
device 328 at step 330. The SNMP information is returned to the SNMP API 324 at step 
332. At step 334, the SNMP information is forwarded to the Configuration Service 304. 
As a last step 336, the get request information of the configuration object is then returned 
to the Client 302 requesting this information. 

In Appendix I which follows, a detailed description of the interfaces and classes 
for use in the present invention follows. Appendix II includes exemplary Code samples 
of base classes to build corresponding network objects. 

The foregoing description merely illustrates the principles of the invention. It will 

thus be appreciated that those skilled in the art will be able to devise various 

arrangements, which, although not explicitly described or shown herein, embody the 

principles of the invention, and are included within its spirit and scope. Furthermore, all 

examples and conditional language recited are principally intended expressly to be only 
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for instructive purposes to aid the reader in understanding the principles of the invention 
and the concepts contributed by the inventor to furthering the art, and are to be construed 
as being without limitation to such specifically recited examples and conditions. 
Moreover, all statements herein reciting principles, aspects, and embodiments of the 
5 invention, as well as specific examples thereof, are intended to encompass both structural 
and functional equivalents thereof. Additionally, it is intended that such equivalents 
include both currently known equivalents as well as equivalents developed in the future, 
i.e., any elements developed that perform the same function, regardless of structure. 

In the claims hereof any element expressed as a means for performing a specified 

10 function is intended to encompass any way of performing that function including, for 

example, a) a combination of circuit elements which performs that function or b) software 
in any form, including, therefore, firmware, microcode or the like, combined with 
appropriate circuitry for executing that software to perform the function. The invention 
as defined by such claims resides in the fact that the functionalities provided by the 

15 various recited means are combined and brought together in the manner which the claims 
call for. Applicant thus regards any means which can provide those functionalities as 
equivalent as those shown herein. Many other modifications and applications of the 
principles of the invention will be apparent to those skilled in the art and are 
contemplated by the teachings herein. Accordingly, the scope of the invention is limited 

20 only by the claims appended hereto. 
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Appendix I 

Description of the interfaces and classes: 

5 

1, BFWBaselfc 
Interface BFWBaselfc 

Abstract interface that shall be supported by all objects to enable objects to be initialized 
1 0 and uninitialized. 

Subinterfaces: 

BFWContainerlfc 



15 Implementing Class: 

m BFWBaselmplAbs 





Method Summary 




01 


void 


initializeQ 






Initialize the state of the object 




void 


uninitialize() 






Uninitialize and invalidate any handles to the 






object 



2. BFWBaselmplAbs 

20 

Class BFWBaselmplAbs 



public abstract class BFWBaselmpl implements BFWBaselfc 

25 Abstract class supported by all objects to enable objects to be initialized and uninitialized. 



Method Summary 




void 


initialize() 

Initialize the state of the object 


String 


initializeQ 

Initialize the state of the object 


void 


uninitialize() 

Uninitialize and invalidate any handles to the 
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object 



3. BFWContainerlfc 

5 public interface BFWContainerlfc extends BFWBaselfc 

Abstract interface in order to be able to contain entities. 
All Subinterfaces: 

BFWActionContainerlfc, BFWObjectContainerlfc 

10 All Implementing Classes: 

BFWContainerlmplAbs 



Method Summary 




int 


getStatusQ 

Returns a status for the object 



15 

4. BFWContainerlmplAbs 

BFWBaselmplAbs 
20 | 

+ BFWContainerlmplAbs 

public abstract class BFWContainerlmplAbs extends BFWBaselmplAbs 
implements BFWContainerlfc 

25 Abstract class that other classes shall implement in order to be able to contain entities. 

Direct Subclasses: 

BFWActionContainerlmplAbs, BFWObjectContainerlmplAbs 

30 



Method Summary 




abstract int 


getStatusO 

Returns a status for the object 



5. BFWObjectContainerlfc 

35 
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public abstract interface BFWObjectContainerlfc extends BFWContainerlfc 

Subinterfaces: 

BFWNetworkEntitylfc 

Implementing Class: 

BFWObjectContainerlmplAbs 



Method Summary 




void 


decrementObjectlnstanceCountQ 


java.lang. String 


getHandle() 

Return a handle that refers to this entity 
object 


java.lang.String 


getlntervalHandleO 

Return a handle that refers to an interval 
object. 


java.lang.Gass 


getObj ectlmplClassO 


int 


getObj ectInstanceCount() 


void 


incrementObj ectInstanceCount() 


void 


setObjectImplGassQava.lang.Gass 
objectClass) 



6. BFWObjectContainerlmplAbs 
BFWBaselmplAbs 
I 

+-BFWContainerImpIAbs 

I 

+~BFWObjectContainerImplAbs 

public abstract class BFWObjectContainerlmplAbs extends 
BFWContainerlmplAbs implements BFWObjectContainerlfc 

Base class for all network objects. 



Direct Subclasses: 

BFWNetworkEntitylmpl 



Method Summary 




protected void 


destroyO 

Delete any objects that are contained by this 
object 


String 


getHandleQ 

Return a handle that refers to this entity object 


String 


getlntervalHandleQ 
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Return a handle that refers to this entity object 


void 


initialize() 

Initialize the state of the object 



7. BFWNetworkEntitylfc 

5 

public abstract interface BFWNetworkEntitylfc extends BFWObjectContainerlfc, 
BFWAttributeContainerlfc 

A BFWNetworkEntity shall allow attribute extensions by implementing the 
10 BFWAttributeContainer Interface. 

Implementing Classes: 

BFWNetworkEntitylmpl 



Method Summary 




void 


addAttributeByQava.lang.Integer 




attributeKey, 




java.lang.Object attributeToAdd) 


void 


addAttributeBy(java.lang.StringattributeKey ? 




BFWObjectContainerlfc 




attributeToAdd) 


void 


addAttributeBy(java.lang.String attributeKey, 




java.lang.Object attributeToAdd) 


boolean 


containsAttributeKey(java.lang.Integer 




attributeKey) 


boolean 


containsAttributeKey(java.lang.String 




attributeKey) 


void 


decrementObjectlnstanceCountQ 


java.lang.Object 


getAttributeByQavaJang.Integer attributeKey) 


java.lang.Object 


getAttributeBy(java.lang.String attributeKey) 


j ava.utiLEnumeration 


getAttributeEntriesQ 


BFWHashtable 


getAttributeList() 


int 


getObj ectlnstanceCountQ 


void 


incrementObj ect!nstanceCount() 


void 


remove AttributeBy (j ava.lang integer 




attributeKey) 


void 


removeAttributeBy(java.lang.String 




attributeKey) 


void 


replaceAttributeBy(java.langinteger 




attributeKey, 
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Java.icui^.v/UJCC'L aiLllUUlC 1 UrvCpiclL/CJ3y J 


void 


replaceAttributeBy(java.lang.String 
attributeKey, 

java.lang.Object attributeToReplaceBy) 







8. BFWAttributeContainerlfc 

public abstract interface BFWAttributeContainerlfc 



Method Summary 




void 


addAttributeBy(j ava.lang.Integer 
attri buteTC e v 

java.lang.Object attributeToAdd) 
Add attributes bv attributeKev 


void 


addAttributeBy (j avalang. String attributeKey , 
BFWObiectContainerlfc attributeToAdd'i 
Add attributes by attributeKey 


void 


addAttributeBy(java.lang.String attributeKey, 
iava lane Obiect attributeToAdd'i 
Add atrributes by attributeKey 


boolean 


containsAttributeKey(java.lang.Integer 
attributeKev') 

Check attribute by attributeKey 


boolean 


containsAttributeKeyQava.lang.String 
attributeKey) 

Check attribute by attributeKey 


java.util.Map 


copyAttributeMapQ 
Copy Attribute Map 


java.lang.Object 


getAttributeBy(java.langJnteger attributeKey) 
Get attribute by attributeKey 


javalang.Object 


getAttributeBy(java.lang.String attributeKey) 
Get attribute by attributeKey 


void 


removeAttributeByOava.lang.Integer 
attributeKey) 

Remove attributes by attributeKey 


void 


removeAttributeBy(j ava.lang. String 
attributeKey) 

Remove attributes by attributeKey 


void 


replaceAttributeBy(java.lang.Integer 
attributeKey, javaiang.Object 
attributeToReplaceBy) 
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Replace attribute by attributeKey 


void 


replaceAttributeBy(java.lang.String 
attributeKey, java.lang.Object 
attributeToReplaceBy) 
Replace attribute by attributeKey 



9. BFWNetworkEntitylmpl 

public class BFWNetworkEntitylmpl extends BFWObjectContainerlmpl 
implements BFWNetworkEntitylfc 

Shall implement the methods defined in the BFWNetworkEntitylfc interface. 

BFWBaselmplAbs 

I 

+-BFWContainerImplAbs 

I 

+.. BFWObjectContainerlmplAbs 

I 

+-BFWNetworkEntityImpl 



Method Summary 




void 


addAttributeBy (j ava.lang.Integer 
attributeKey, 

java.lang.Object attributeToAdd) 
Add atrributes by attributeKey 


void 


addAttributeBy(java.lang.String attributeKey, 
BFWObjectContainerlfc attributeToAdd) 
Add atrributes by attributeKey 


void 


addAttributeBy(java.lang.String attributeKey, 
java.lang.Object attributeToAdd) 
Add atrributes by attributeKey 


boolean 


containsAttributeKey(java.lang.Integer 
attributeKey) 

Check attribute by attributeKey 


boolean 


containsAttributeKey(java.lang.String 
attributeKey) 

Check attribute by attributeKey 


java.util.Map 


copyAttributeMapO 
Copy Attribute Map 


java.lang.Object 


getAttributeBy(j ava.lang.Integer attributeKey) 
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Get attribute by attributeKey 


j ava. lang . Obj ect 


getAttributeBy(j ava.lang. String attributeKey) 
Get attribute by attributeKey 


void 


removeAttributeBy (j ava.lang integer 
attributeKey) 

Remove attributes by attributeKey 


void 


removeAttributeBy(javaiang.String 
attributeKey) 

Remove attributes by attributeKey 


void 


replaceAttributeBy (j ava.lang integer 
attributeKey, java.lang.Object 
attributeToReplaceBy) 
Replace attribute by attributeKey 


void 


replaceAttributeBy(javaiang.String 

a I LI 1 U U LC JvC y , JaVa.lcUlg.wDjeCl 

attributeToReplaceBy) 

Replace attribute by attributeKey 


void 


setObjectImplClass(javaiang.Class 
objectClass) 



10, BFWActionContainerlfc 

5 public interface BFWActionContainerlfc extends BFWContainerlfc 

This is the base interface for objects that are actions and usually not stored in the 
database. 

10 



Method Summary 




BFWObjectContainerlfc 


getOwningEntityRef() 
Get owning entity reference 


j avaiang. StringBuffer 


getTraceData(javaiang.String s) 
Get Trace Data 


void 


setOwningEntityRef(BFWObjectContainerIfc 
entity) 

Set the owning entity reference 


void 


setEquai(BFWActionContainerIfc 
transientEntity) 

Sets the state of the Transient equal to the 
state of the specified source transient. 
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11. BFWActionContainerlmplAbs 

public abstract class BFWActionContainerlmplAbs extends BFWContainerlmpl 
implements BFWActionContainerlfc 

BFWBaselmplAbs 

I 

+- BFWContainerlmplAbs 
I 

+-- BFWActionContainerlmplAbs 

Direct Subclasses: 

BFWActionlmplAbs 



Method Summary 




boolean 


equals(j ava. lang. Obj ect transientToCompare) 
Compare two transient objects for equal state 
values 


BFWObjectContainerlfc 


getOwningEntityRefQ 
Get owning entity reference 


int 


getPersistenceStatusQ 
Get Persistence status 


j ava.lang. StringBuffer 


getTraceData(java.lang.String newLinePrefix) 
Get trace data 


boolean 


isStatelessO 

Is the object stateless 


void 


setEqual(BFWActionContainerIfc dependent) 
Set the state of the Transient entity equal to 
the state of the specified source Transient 

entity 


void 


setOwningEntityRef(BFWObjectContainerIfc 

ref) 

Set owning entity reference 


int 


hashCode() 

Returns the hash code 



12. BFWActionlfc 
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public interface BFWActionlfc extends BFWActionContainerlfc 

Interface class BFWActionlfc defines all actions required for objects 

5 Implementing Class: 

BFWActionlmplAbs 



Method Summary 






Can the action be done. 


V *J1LI 


rloAllA 

Does all the operations for the action 


V VJ1U. 


H c% A c\\ c\v\ (\ 

\Jl\jjr\\s 11 UI1I j 

Defines a transaction scope around the do A11Q 
method 


void 


initialize() 
Initialize the action 


void 


initialize(BFWHandleAbs handle, boolean 
flag Java Jang. String s ? int i) 
Initialize the action 


void 


setReturnAction(boolean flag) 
Set the return action 


void 


setState(int i) 

Set the state of the action 


void 


setTarget(BFWNetworkEntityImpl entity) 
Sets the target of the action. 



10 13. BFWActionlmplAbs 

public abstract class BFWActionlmplAbs extends BFWActionContainerlmplAbs 
implements BFWActionlfc 

BFWActions encapsulate tasks and other actions that control or modify network objects. 

15 

BFWBaselmplAbs 

I 

+- BFWContainerlmplAbs 
20 j 

+-- BFWActionContainerlmplAbs 
I 

+-- BFWActionlmplAbs 
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Method Summary 




protectee void 


destroy() 

Destroys the action object 


void 


doBegin() 
Start the action 


void 


doTransaction() 

Defines a transaction scope around the doAll() 
method 


boolean 


equals(BFWActionContainerIfc object) 
Determines if this object's state is equal to the 
speciiieci oDject argument 


boolean 


getReturnActionQ 

Is the return action supported 


void 


handleReset() 

Handle the reset of the action. 


int 


hashCode() 

Return hashCode of object 


void 


initialize() 
Initialize the action 


void 


initialize(BFWHandleAbs newHandle, 
boolean returnAction, java.lang.String 
actionLabel, int undoType) 
Initialize the action 


void 


redo() 

Redo the action 


void 


resetQ 

Reset the action 


void 


setEqual(BFWActionContainerIfc object) 

oCLa UlC DlalC Ul lllld UDJCLL lO Slate OI anOuier 

object of the same 
type 


void 


setReturnAction(boolean returnAction) 
Set the return action 


abstract 
void 


setTarget(BFWNetworkEntityImpl entity) 
Sets the target of the action. 
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Appendix II 

Code Samples of Base classes to build Network Ob jects 

GenericEntitylfc 

public interface GenericEntitylfc 
extends BFWNetworkEntitylfc 



/** Initialize the object and its attributes 
** @param BFWServerRequest request 
** @returnvoid 

** ©exception BFWExceptionAbs 
15 * * ©exception NXException Exception sent back to the CI ient */ 
/* */ 

public abstract void initialize(BFWServerRequest request) 
throws BFWExceptionAbs, NXException; 

20 public abstract void initialize(NXObject obj) 

throws BFWExceptionAbs, NXException; 



public abstract void initializeO 
throws BFWExceptionAbs, NXException, 



public abstract long getlntervalQ; 
public abstract Date getStartTimeO; 
30 public abstract Date getStopTimeO; 

public abstract void setHandle(String handle); 
public abstract String getHandleO; 

35 

public abstract void setIntervalHandle(String newHandle); 
public abstract String getlntervalHandleO; 
40 public abstract Vector getClientCacheO; 

public abstract void updateClientCache(NXObject obj); 
public abstract void updateClientCache(NXObjectList objList); 

45 } 

GenericEntitylmpIAbs 

public abstract class GenericEntitylmpIAbs extends BFWNetworkEntitylmpl 
50 implements GenericEntitylfc 
{ 

/* */ 

/* * GenericEntitylmpIAbs null Contructor */ 
/* 

55 public GenericEntitylmpIAbsO 

{ 

} 

/* */ 

60 /** Initialize the object 

** This is an abstract method that must be implemented by 

** concrete subclasses of this class 

** @param BFWServerRequest request 
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** @return void 

** ©exception BFWExceptionAbs 

* * ©exception NXException */ 

/* */ 

5 public abstract void initialize(BFWServerRequest request) 

throws BFWExceptionAbs, NXException; 

public abstract void initiaIize(NXObject obj) 
throws BFWExceptionAbs, NXException; 

10 

public abstract void initializeQ 

throws BFWExceptionAbs, NXException; 

public abstract long getlntervalO; 

15 

public abstract Date getStartTimeO; 

public abstract Date getStopTimeO; 
20 public abstract void setHandle(String handle); 

public abstract String getHandleO; 
^ public abstract void set!ntervalHandle(String newHandle); 

public abstract String getlntervalHandleQ; 

public abstract Vector getClientCacheO; 
30 public abstract void updateClientCache(NXObject obj); 

public abstract void updateClientCache(NXObjectList objList); 

} 

35 

CircuitAxAtmlfc 

public interface CircuitAxAtmlfc 
extends CircuitGenericEntitylfc 

40 { 

public abstract String getNameO; 
public abstract int getlflndex(int endpoint); 
45 public abstract int getVpi(int endpoint); 

public abstract int getVci(int endpoint); 
public abstract int getDlci(int endpoint); 

50 

public abstract String getIPAddress(int endpoint); 
public abstract int getSlot(int endpoint); 
5 5 public abstract int getPPort(int endpoint) ; 

public abstract int getChanneI(int endpoint); 
public abstract int getLPortType(int endpoint); 

60 

public abstract int getEndpointType(int endpoint); 
public abstract int getCardType(int endpoint); 
65 public abstract int getSwitchType(int endpoint); 

public abstract int getSwitchRevisionNumber(int endpoint); 
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public abstract Hashtable getAttributesForEndpoint(int endpoint); 
public abstract MOSIntervalCache getlntervaiCacheO; 

5 } 

CircuitAxAtmlmpl 

public class CircuitAxAtmlmpl extends CircuitGenericEntitylmplAbs 
1 0 implements CircuitGenericEntitylfc 

{ 

public CircuitAxAtmlmplQ 

{ 
} 



15 



public void initialize(BFWServerRequest newRequest) 
throws BFWExceptionAbs, NXException 



{ 

// Set the Circuit attribute cache size 
20 super.initialize(DEF_CACHE m SIZE); 
this.request = request; 

objectID = requestgetObjectO-getObjectldO; 
argList = requestgetObjectO-getAttrListO; 

handle = requestgetObject0.getObjectId0.getComponent(' , NAME ,, ).toString0; 
25 // Set the Circuit Interval Cache size which will be populated 

// by data retrieved from the data collector. 

intervalCache = new MOSIntervaICache(DEF_INTERVAL_CACHE_SIZE); 

switch(request.getTypeO) 
30 { 

case NXCommands.GET_STATS_CMD: 

case NXCornmands.GET_DEMAND STATS CMD : 

case NXCommands.GET_PERIODIC_STATS_CMD: 
case NXCommands.START_MONITOR_CMD: 
35 //All attributes of Circuit Type and Card Type 

// need to be initialized 
setFilterAttributesO; 
setObjectTypeO; 
break; 

40 case NXCommands.GETCMD: 

case NXCommands.GET__OPER_INFO_CMD : 
setFilterAttributesO; 
setSpeciflcArtrsO; 
break; 

45 case NXCommands.STOP_STATS_CMD: 

case NXCommands.STOPJV10NITOR_CMD: 
setFilterAttributesO; 
break; 

default: 

50 break; 
} 

} 

/* y 

55 /** Initialize the Circuit object with the NXObject 
** This method is used on the client side. 
** @param NXObject obj 
** @return void */ 
/* *, 

60 public void initialize(NXObject obj) 

throws BFWExceptionAbs, NXException 

{ 

// Set the LPort attribute cache size 
super.initialize(DEF_CACHE_SIZE); 
65 // List of objects that are returned from the server 

clientObjectList = new VectorO; 
object = obj; 
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55 



argList = obj.getAttrListO; 

handle = obj.getObjecttdO.getComponentC'NAME^.toStringO; 

setFilterAttributesO; 

setObjectTypeO; 

5 } 

/* */ 

/** Initialize the Circuit object with the attribute list 
** This method is used to initialize the object from the 
10 ** cache manager 

** @retum void */ 

/* */ 

public void initializeO 
throws BFWExceptionAbs, NXException 

15 { 

// Set the Circuit attribute cache size 
super.initialize(DEF_CACHE_SIZE); 

} 

20 public Enumeration getAHAttributesO 

{ 

return getAttri buteEntries 0 ; 

} 

25 public void setFilterAttributesO 

{ 

NXArg arg - null; 
int i - 0; 

30 if (argList = null) 

return; 

for (intx = 0; x<argList.lengthO; x++) 
{ 

35 arg = argListgetArgAt(x); 

i = arg.getldO; 

switch(i) 
{ 

40 case NXCircuitAttributes.NAME: 

setName(i); 
break; 

caseMOSCircuitAttributes.ENDl_IFINDEX: 
45 setIflndex(ENDPOINTl , i); 

break; 

case MOSCircuitAttributes.END2_IFrNDEX: 
setIflndex(ENDPOINT2 3 i); 
50 break; 

case MOSCircuitAttributes.END3 JFINDEX: 
setIflndex(ENDPOINT3 ? i); 
break; 



case MOSCircuitAttributes.ENDl_VPI: 
setVpi(ENDPOINT 1 , i); 
break; 



60 case MOSCircuitAttributes.END2_VPI: 

setVpi(ENDPOINT2, i); 
break; 

case MOSCircuitAttributes.END3_VPI. 
65 setVpi(ENDPOINT3, i); 

break; 
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case MOSCircuitAttributes.ENDl_VCI: 
setVci(ENDPOINTl,i); 
break; 

5 case MOSCircuitAttributes.END2_VCI: 

setVci(ENDP0INT2 s i); 
break; 

case M0SCircuitAttributes.END3_VCI: 
10 setVci(ENDPOINT3, i); 

break; 

case MOSCircuitAttributes.ENDl_DLCI: 
setDlci(ENDPOINTl, i); 
1 5 break; 

case MOSCircuitAttributes.END2_DLCI: 
setDlci(ENDPOINT2, i); 
break; 

20 

case MOSCircuitAttributes,END3_DLCI: 
setDIci(ENDPOINT3 , i); 
break; 

25 case MOSCircuitAttributes.ENDl_CATEGORY_TYPE: 

setEndpointType(ENDPOINTl, i); 
break; 

case MOSCircuitAttributes.END2_CATEGORY_TYPE: 
30 setEndpointType(ENDPOINT2, i); 

break; 

case MOSCircuitAttributes.END3_CATEGORY_TYPE: 
setEndpointType(ENDPOINT3, i); 
35 break; 

caseMOSCircuitAttributes.ENDl_SWITCHJPADDR: 
setIPAddress(ENDPOINTl, i); 
break; 



40 



caseMOSCircuitAttributes.END2_SWITCHJPADDR; 
setIPAddress(ENDPOINT2, i); 
break; 



45 case MOSCircuitAttributes.END3_SWTTCHJPADDR: 

setIPAddress(ENDPOINT3, i); 
break; 

case MOSCircuitAttributes.ENDl_SLOT: 
50 setSiot(ENDPOINT 1 , i); 

break; 

case MOSCircuitAttributes.END2_SLOT. 
setSlot(ENDPOINT2, i); 
55 break; 

case MOSCircuitAttributes.END3_SLOT: 
setSlot(ENDPOINT3, i); 
break; 

60 

case MOSCircuitAttributes.ENDl_PPORT: 
setPPort(ENDPOINTl, i); 
break; 

65 case MOSCircuitAttributes.END2_PPORT: 

setPPort(ENDPOINT2, i); 
break; 
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case M0SCircuitAttributes.END3JPP0RT: 
setPPort(ENDPOINT3 5 i); 
break; 

5 

case MOSCircuitAttributes.ENDl_CHANNEL; 
setChannel(ENDPOINTl, i); 
break; 

10 case MOSCircuitAttributes.END2_CHANNEL: 

setChannel(ENDPOINT2 > i); 
break; 

case MOSCircuitAttributes END3_CHANNEL: 
15 setChannel(ENDPOINT3, i); 

break; 

case MOSCircuitAttributes.ENDlJLPORT_TYPE: 
setLPortType(ENDPOINTl , i); 
20 break; 

case MOSCircuitAttributes.END2JLPORT_TYPE: 
setLPortType(ENDPOINT2 5 i); 
break; 



25 



65 



caseMOSCircuitAttributes.END3_LPORT__TYPE: 
setLPortType(ENDPOINT3 , i); 
break; 



30 case MOSCircuitAttributes. END 1_CARDTYPE: 

setCardType(ENDPOINTl, i); 
break; 

case MOSCircuitAttributes. END2_CARD_TYPE: 
35 setCardType(ENDPOINT2, i); 

break; 

case MOSCircuitAttributes.END3_CARD_TYPE; 
setCardType(ENDPOINT3, i); 
40 break; 

case MOSCircuitAttributes.ENDl_SWITCH_TYPE: 
setSwitchType(ENDPOINTl, i); 
break; 

45 

case MOSCircuitAttributes.END2_SWITCH_TYPE: 
setSwitchType(ENDPOINT2, i); 
break; 

50 caseMOSCircuitAttributes.END3_SWITCH_TYPE: 
setSwitchType(ENDPOINT3, i); 
break; 

caseMOSCircuitAttributes.ENDl_SWITCH_REVISION_NO: 
5 5 setSwitchRevisionNumber(ENDPOINT 1 , i); 

break; 

case MOSCircuitAttributes.END2_SWITCH_REVISION_NO: 
setSwitchRevisionNumber(ENDPOINT2, i); 
60 break; 

case MOSCircuitAttributes.END3_SWITCH_REVISION_NO; 
setSwitchRevisionNumber(ENDPOINT3, i); 
break; 



case MOSFilterAttributes.MOS_INTERVAL: 
setlnterval(i); 
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break; 

case MOSFilterAttributes.MOS_START_TIME: 
setStartTime(i); 
5 break; 

case M0SFilterAttributes.MOS_STOP_TIME: 
setStopTime(i); 
break; 

10 

default: 
break; 
} 

} 

15 } 



} 

} 

20 

LPortEthcrnctlfc 

public interface LPortEthernetlfc 
extends LPortGenericEntitylfc 

25 { 

public abstract String getLPortName(); 
public abstract int getLPortTypeO; 
3 0 public abstract int getServiceTypeO ; 

public abstract int getlntefaceNumberO; 
public abstract String getlPAddressQ; 

35 

public abstract String getNetworkId(); 
public abstract Vector getAllCategoriesForLPortO; 
40 public abstract String getDisplayStringForCategory(int category); 

public abstract Hashtable getAttributesForCategory(int category); 
public abstract MOSIntervalCache getlntervalCacheQ; 

45 

} 

LPortEthernetlmpl 

50 public class LPortEthernetlmpl extends LPortGenericEntitylmplAbs 
implements LPortGenericEntitylfc 

{ 

public LPortEthernetlmplO 

{ 

55 } 

/* */ 

/** Initialize the LPort object 

** This method is used on the server side. 
60 * * @param BFWServerRequest request 

** @returnvoid */ 
/* */ 

public void initialize(BFWServerRequest request) 
throws BFWExceptionAbs, NXException 

65 { 

// Set the LPort attribute cache size 
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super Jnitialize(DEF_LPORT_CACHE_SIZE); 
this.request = request; 

objectID = request.getObject0.getObjectIdO; 
argList = request.getObject0.getAttrList(); 
5 handle = request.getObjectO.getObjectldO.getComponentC'NAME'O.toStringO; 

switch(request.getTypeO) 

{ 

case NXCornmands.GET_STATS_CMD: 
10 case NXCommands.GET_DEMAND_STATS_CMD: 

case NXCommands.GET_PERIODIC_STATS_CMD: 
case NXCommands. STARTMONITORCMD: 
//All attributes of LPort Type and Service Type 
// need to be initialized 
15 setFilterAttributesO; 

setObjectTypeO; 
break; 

case NXCommands, GET_CMD: 

case NXCornmands.GET_OPER_INFO_CMD: 
20 setFilterAttributesO; 

setSpecificAttrsO; 
break; 

case NXCommands.STOP_STATS_CMD: 

case NXCommands,STOP__MONITOR_CMD; 
25 setFilterAttributesO; 

break; 

default: 

break; 

} 

30 } 

/* */ 

/** Initialize the LPort object with the NXObject 
** This method is used on the client side. 
35 ** @param NXObject obj 

* * @return void */ 
/* */ 

public void initialize(NXObject obj) 
throws BFWExceptionAbs, NXException 

40 { 

// Set the LPort attribute cache size 
supeninitiaIize(DEF_LPORT_CACHE_SIZE); 
// List of objects that are returned from the server 
clientObjectList = new VectorO; 
45 object = obj; 

argList = obj.getAttrListO; 

handle = obj.getObjecadO.getComponentCNAME^.toStringO; 

setFilterAttributesO; 

setObjectTypeO; 

50 } 

/* * ; 

/** Initialize the LPort object with the attribute list 
** This method is used to initialize the object from the 
55 ** cache manager 

** @return void */ 

/* */ 

public void initializeO 
throws BFWExceptionAbs, NXException 

60 { 

// Set the LPort attribute cache size 
super.initialize(DEF_LPORT_CACHE_SIZE); 

} 

65 public Enumeration getAlIAttributesO 

{ 

return getAttributeEntriesO; 
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10 



15 



25 



50 



60 



} 



public void setFilterAttributesO 
{ 

NXArg arg = null; 
int i = 0; 

if (argList = null) 
return; 

for (int x = 0; x<argListlength(); x++) 
{ 

arg = argList. getArgAt(x); 
i = arg.getld(); 

switch(i) 
{ 



case NXLPortAttributes.SERVICE__TYPE; 
setServiceType(i); 
20 break; 



case NXLPortAttributes.NAME: 
setLPortName(i); 
break; 

case NXLPortAttributes.TYPE: 
setLPortType(i); 
break; 

30 case NXLPortAttributes JFJNDEX: 

setlnterfaceNumber(i); 
break; 

case NXSwitchAttributes JP_ADDRESS: 
35 setlPAddress(i); 

setNetworkld(i); 
break; 

case MOSFilterAttributes.MOS_INTERVAL: 
40 setlnterval(i); 

break; 

case MOSFiiterAttributes.MOS__START_TIME: 
setStartTime(i); 
45 break; 

caseMOSFiiterAttributes.MOS_STOP__TIME: 
setStopTime(i); 
break; 



55 } 

r 



default: 

break; 



} 



Code Samples of Action Objects: 



BFWAddActionlfc 
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public interface BFWAddActionlfc 
extends BFWActionlfc 

{ 

/* */ 

5 /** Initialize the add action 

** @param BFWServerAddRequest addRequest 
** @return void 

** ©exception BFWExceptionAbs */ 

/* */ 

1 0 public abstract void initialize(BFWServerAddRequest addRequest) 
throws BFWExceptionAbs, NXException, 

} 



15 BFWAddActionlmpl 

public class BFWAddActionlmpl extends BFWActionlmplAbs 
implements BFWAddActionlfc 

{ 

20 /* */ 

/** Set the target object to perform the action on 
** @param BFWNetworkEntitylmpl actionTarget 
** ©return void 

** ©exception BFWExceptionAbs */ 

25 /* */ 

public void setTarget(BFWNetworkEntityImpl actionTarget) 
throws BFWExceptionAbs 

{ 

if(actionTarget != null) 
30 if(actionTarget instanceof BFWNetworkEntitylmpl) 

target = actionTarget; 

} 

/* */ 

35 /* * Get the target obj ect to perform the action on 

** ©return BFWNetworkEntitylmpl */ 

/* */ 

public BFWNetworkEntitylmpl getTargetO 
{ 

40 return target; 

} 



/* 



/** Do the verification on the object before performing the action 
45 ** ©return void 

** ©exception BFWExceptionAbs 

** ©exception NXException */ 
/* */ 

protected void handle VerificationQ 
5 0 throws BFWExceptionAbs, NXException 

{ 

try 

{ 

55 verificationMethod = target.getObjecamplCIass0.getDeclaredMethod( f, addVerification n 5 null); 

verificationMethod.invoke(nulI, null); 

} 

catch (InvocationTargetException e) 
{ 

60 BFWResponseManager.sendResponse(request, (NXException)e.getTargetExceptionO); 

catch (Exception ex) 

{ 
} 

65 } 
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10 



/*_ */ 

/** Perform the synchronous add action. 
** @return void 

** @exception BFWExceptionAbs 
** @exception NXException */ 
/* *, 

protected void handleDoQ 
throws BFWExceptionAbs, NXException 

< 



try 
{ 



NXError error = 

BFWDataAccessManager.getInstanceO-addObject(target, request); 
1 5 if (error.getErrorCodeO != NXCommonErrors .NO_ERROR) 



{ 



20 { 



throw new NXException(error.getErrorCodeO); 

} 

e!se 



BFWResponseManager.sendResponse(request, error); 

} 

} 

catch (NXException e) 
25 { 

throw e; 

} 



30 /* */ 

/** Initialize all attributes for the add action 
** @param BFWServerAddRequest addRequest 
** @return void 

** ©exception BFWExceptionAbs 
35 ** ©exception NXException */ 
/* */ 

public void initialize(BFWServerAddRequest addRequest) 
throws BFWExceptionAbs, NXException 

{ 

40 request = addRequest; 

} 

BFWNetworkEntitylmpI target = null; 
protected BFWServerAddRequest request = null; 
45 private static Method verificationMethod; 



BFWDeleteActionlfc 

50 public interface BFWDeleteActionlfc 
extends BFWActionlfc 

{ 

/* */ 

/** Initialize the delete action 
55 ** @param BFWServerDeleteRequest deleteRequest 

** @return void 

** ©exception BFWExceptionAbs */ 

/* y 

public abstract void initialize(BFWServerDeleteRequest deleteRequest) 
60 throws BFWExceptionAbs, NXException; 

} 



BFWDeleteActionlmpl 

65 public class BFWDeleteActionlmpl extends BFWActionlmplAbs 
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implements BFWDeleteActionlfc 

{ 

/* */ 

/** Set the target object to perform the action on 
5 ** @param BFWNetworkEntitylmpI actionTarget 

** @return void 

** ©exception BFWExceptionAbs */ 
/* . */ 

public void setTarget(BFWNetworkEntityImpl actionTarget) 
10 throws BFWExceptionAbs 

{ 

if(actionTarget != null) 
if(actionTarget instanceof BFWNetworkEntitylmpI) 
target = actionTarget; 

15 } 



/* 



/** Get the target object to perform the action on 
** @return BFWNetworkEntitylmpI */ 

20 /* */ 

public BFWNetworkEntitylmpI getTargetQ 
{ 

return target; 

} 

25 

/* */ 

/** Do the verification on the object before performing the action 
* * @return void 

** ©exception BFWExceptionAbs 
30 ** ©exception NXException */ 
/* */ 

protected void handleVerificationO 
throws BFWExceptionAbs, NXException 

{ 

35 try 

{ 

verificationMethod = target.getObjectImplClass0-getDeclaredMethod("deleteVerification w s null); 
verificationMethod.invoke(nuli, null); 

} 

40 catch (InvocationTargetException e) 

{ 

BFWResponseManager.sendResponse(request, (NXException)e.getTargetExceptionO); 

} 

catch (Exception ex) 
45 { 
} 

} 



/* 



50 /** Perform the synchronous delete action. 

** ©return void 

** ©exception BFWExceptionAbs 
** ©exception NXException */ 
/* */ 

55 protected void handleDoO 

throws BFWExceptionAbs, NXException 

{ 

try 
{ 

60 NXError error = 

BFWDataAccessManager.getInstance0-deleteObject( 
target, request); 

if (error.getErrorCodeO != NXCommonErrors.NO_ERROR) 
65 { throw new NXException(error.getErrorCodeO) } 

else 

{BFWResponseManager.sendResponse(request, error);} 
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} 

catch (NXException e) 
{ 

throw e; 

5 } 
} 

/* */ 

/** Initialize all attributes for the delete action 
10 ** @param BFWServerDeleteRequest deieteRequest 

** @return void 

** ©exception BFWExceptionAbs 
** ©exception NXException */ 
/* */ 

1 5 public void initialize(BFWServerDeIeteRequest deieteRequest) 

throws BFWExceptionAbs, NXException 

{ 

request = deieteRequest; 

> 

20 

BFWNetworkEntitylmpl target = null; 

protected BFWServerDeleteRequest request = null; 

private static Method verificationMethod; 

} 

25 
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